y 



Unlink <modname> Usage : Unlinks module(s) from memory @WCREATE 
Syntax: Wcreate [opt] or AvX [-s=type] xpos ypos xsiz ysiz fcol bcol [bord] 
Usage : Initialize and create windows Opts : -? = display help -z = read 
command 



lines from 

stdin -s=type 
= set screen 
type for a 
window on a 
Usage : Displays 






new 



screen 



@ XMO D E 
Syntax: 
X M o d e 
< devname> 
[params] 
SCF type device 



or changes theparameters of an 
@COCOPR Syntax: cocopr [<opts>] {<path> [<opts>]} Function: display file 
in specified format gets defaults from /dd/sys/env.file Options : -c set columns 
per page -f use form feed for trailer -h=num set number of lines after 
header -l=num set line length -m=num set left margin -n=num set starting 
line number and incr -o truncate lines longer than bilen -p=num set number 
of lines per page -t=num number of lines in trailer -u do not use title 



ffliilJSIlii 
iilSiiilli! 

;stjSxRiiil 









Control Panel to set 



and monitor 



-u= title use specfied title -x=num set starting page number -z[=path] read file 
names from stdin or <path> if given ©CONTROL Syntax: control [-e] Usage 

palettes, mouse and keyboard parameters 

type for 

M u 1 t i - V u e . 

Selectable from 
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desk 
menu 
Control 
Opts 



utilities 

as the 

Panel. 

-e = 



Selectable from desk utilities 
Graphics calculator utility for 



execute the 

environment file 
@ G C L O C K 
Syntax: gclock 

Usage : Alarm 
clock utility for 
M u 1 t i - V u e . 
menu as Clock. @GCALC 
Multi-Vue. Selectable form 
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Syntax: gcalc 
desk utilities menu 



Usage 



as 



Volume 7 



May 1993 



Number 4 



Calculator. @GCAL Syntax: gcal Usage : Calendar/Memo book utility for 
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Well, here it is, the month of May. When you 
read this, Gordon Bentzen will be in USA chatting 
with Colour Ccmputer users over there, and getting 
as much information for us as he can. I am standing 
in for him this month. We are looking forward to 
hearing about new material, and new alliances with 
othe 039 users around the world. Who knows what 
will eventuate? I think it may well be the start of 
a whole new era for the Australian 0S9 users. 

I continue to be surprised by calls from Colour 
Corputers who want to become niEntiers of this 
Usergroup. Here I keep thinking that all the old 
users have got out of the CoCo scene, but no.... 
more pop up all the time. Great! 



rewrite a file starting from an offset within that 
file. Sonetimes useful for cutting extraneous data 
from the front of a file. It is programnes like 
that which I love to write. Usually someone at a 
Usergroup meeting will say, how can I do this, or, 
why doesn't this prograirme allow' this? This will 
usually get rny ideas flowing hot again, and out pops 
a little utility prograrrme . It doesn't matter that 
the utility has been done before, because usually t 
have learnt something in it's writing. Please ask 
me to solve your problems, it will help me to 
continue my learning of the C progranming language. 
As always, if you haven't got the 0S9 C compiler, 
the prograrnns will become available in our PD 
library. 



I know we have talked about this before, and I 
have seen the same comnents on the 039 echo on FIDO- 
Net, but here goes anyway. I would like to know 
what you people out there would like see in the way 
of software for 089. Maybe it is already written, 
and we can tell you where to find it, either in the 
Public Domain, or as cormercial software. If your 
wants are not too extravagant, maybe we will be able 
to write it ourselves. In fact I'm sure some of you 
will have done sane of that already. Maybe you have 
written a script file that does something on your 
system? Please realise that other people can 
benefit from what you have done, even if it seems 
insignificant to you. Have a look at the article 
about script files in this issue, it gives some 
examples of how things can be done without writing 
special prograrnnes to do them. I myself use script 
files for a lot of things. If I want to call up the 
Profile database programne, I use a script called 
'PF' which changes directories for me, and starts up 
Profile. That way it is always at hand. 

In this issue also, I have written a utility to 



The last of the series 'A C Tutorial' is 
featured in this issue. It has been a long stretch, 
but I think it has been worth printing. While some 
of the corments in the series have been specifically 
MS-DOS oriented, most of the text could be applied 
to the 0S9 C ccnpiler. The complete archive, which 
includes the source code of the programnes 
mentioned, is available from our PD library. It is 
rather large, 198,400 bytes, so users with only 
single-sided disk drives would need to have it split 
up. I'm sure Jean-Pierre would do that if you ask 
hime nicely. 

I would like to hear from you what you would 
like to feature in the Newsletter as a replacement. 
We have also received a PASCAL tutorial, but I have 
not really given much thought to using that for two 
reasons. 1. The tutorial is aimed at the MS-DOS 
Turbo-Pascal, and 2. 0S9 Pascal is not very widely 
used, and is very out-of-date. Let me know what you 
think. 

Regards , 
Bob Devries 
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Script2 - Seme More Shell+ v2.0 Scripts 
by Steve Clark 



This file contains sane more shell+ scripts for 
the new version of Shell+ for OS-9 Level II on the 
Color Computer. With the numerous capabilities 
provided by Ron Lamnardo, Kevin Darling and Kent 
Myers, I offer these as suggestions only, you will 
need to modify them to your liking. In most cases, I 
am sure there are alternate ways to do what these 
scripts do. Some of these use other programs 
available on-line on various information services. I 
will try to mention these when they are encountered. 

Batchfmt - Batch Formatting Floppies 

If you need to format a series of floppies, say 
to use for backing up your hard disk, this shell 
script automates some of the process. You supply an 
initial name, and the script formats a floppy with 
"nameOOOOr* then asks if you want to do it again. 
By replying yes, the script prcnpts you to insert a 
new disk, etc. Drive /dO is hard wired into the 
script, but you can change it (or add an option to 
ask which drive) . It uses the GQIO and 1^ options 
from the new she 11+. 

"batchfmt 

display c 

load format 

prcnpt Disk Name: var.O 

*loop 

inc.l 

display c 

echo Place disk in drive /dO 

pronpt Press ENIER when ready to format %0%1 : 

var.2 

fonnat /dO r "%0%1" 

display 7 a 

protpt Another (y/n): 

if [ -y ] 

clrif 

goto loop 
fi 

unload format 
echo Batchfmt Done. 

Deskmate - Run Deskmate 3 Applications 

This shell script runs deskmate 3 applications 
by presenting a menu and starting either the 
deskmate interface, or one of several deskmate 
applications. As with other scripts, you will have 
to use your own subdirectory names (I use 
/dd/usr/data/ss). It will set up a type 1 windcw 
and run the specified deskmate program in that 
window. See the script for further information. 



*deskmate - deskmate execute 

onerr goto +trap 

display c 

chd /dd/USR/DATA/SS 

chx /dd/USR/DATA/SS/CMDS 

path=/dd/CMDS 

echo DeskMate 

display a 

echo 1 DeskMate Desktop 

echo 2 Spreadsheet 

echo 3 Word Processing 

echo 4 Ccmnanications 

display a 

prompt Select: var.O 

goto +label%0 

*labell 

xmode /w6 type=l; display c>/w6 (deskO»/w6;MiiDde 

/w6 type=80)6t 

goto +f inis 

*label2 

xmode /w7 type=l; display c>/w7 (desk 

dmledgerO»/w7;Kmode /w7 type=80)& 

goto +f inis 

*label3 

yirode /w8 type=l; display c>/w8 (desk dmtextO»/w8; 

Mnode /w8 type==80)& 

goto +finis 

*label4 

yitode /w9 type=l; display c>/w9 (desk dmterm 

termstatO»/w9;janode /w9 type=80)& 

*finis 

display a 

echo Task started in another window. 

echo Use CLEAR key to change windows. 

*trap 

Playit - Play Sounds from a Menu 

I found Kevin Darling's play program 
fascinating to use, and have collected several 
digitized sound files. The one thing I never can 
remenber is what parameters to pass to each file. 
Qie way to handle this (or to have the ccnputer 
remeirber for you) is to maintain a script file such 
as "playit" and put the parameters in. Again, 
specify your own directory structure. 



* playit - play sounds 

onerr goto +lab 

load play 

chd /dd/usr/ sound 

*repeat 

echo 1 HAL from 2001 

Glass 



2 Late Night Breaking 
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4 Captain Kirk 
6 Scotty 
8 Uugh 



echo 3 I'll be back 

echo 5 Disrupter 

echo 7 Clint Eastwood 

echo 9 Monty Python 

echo 

pronpt Which Sound (ENTER to Quit): var.O 

goto +lab%0 

*labl 

echo HAL - Can't Do 

play 18 cantdo.snd</l 

goto repeat 
*lab2 

play 11 davidl.pla</l 

goto repeat 
*lab3 , 

play 28 back.mac</l 

goto repeat 
*lab4 

play -29 kirk.pla</l 

goto repeat 
*lab5 

play -28 dsrpt.pla</l 

goto repeat 
*lab6 

play -28 scotty. pla</l 

goto repeat 
*lab7 

play -11 clint.pla</l 

goto repeat 
*lab8 

play 40 laugh. pla</l 

goto repeat 
*lab9 

play -10 bing.pla</l 

goto repeat 
*lab 
unload play 

Address - Build an Address File 

This won't replace a database by any means, but 
it is a quick and dirty way to create a program to 
obtain prcnpted input from a user. It adds to an 
address file called "address.dat". You can use the 
same idea to create any type of ascii data file. It 
uses the IF, append, prcrrpt, and GOTO features of 
the new shell+. 

^address 

var .0="address . dat" 

^repeat 

proipt Last Name: var.l 

praipt First Name: var. 2 

pronpt Address: var. 3 

prcrrpt City, State: var. 4 

prcript Zip: var. 5 

prcrrpt Phone ( 999-999-9999 ) : var . 6 



Add to file (y/n): var. 9 



prcrrpt 

if %9=y 

echo %1, %2>%0 

echo %3>%0 

echo ^ %5>%0 

echo %6>%0 

echo ->4-%0 
else 

echo Record not added, 
fi 

prcrrpt Add Another (y/n): var. 9 
if %9=y 

clrif 

goto repeat 
else 

echo Done. %0 Data input corrplete. 
fi 

Man - Online Manuals 

One of the nice features of having a hard disk 
is the ability to keep some things on-line which you 
would otherwise have to store on floppy or in the 
case of documentation, keep printed copies. I 
created this shell script to siinilate the MAN 
ccrrmand (somewhat) by providing access to 
documsntation files. I have a subdirectory called 
/dd/usr/man which stores the text files I want to 
access, and use this script to choose the one I want 
to view. Pete Lyall's MCRE ccrrmand allows you to 
page back and forth within a file, and is perfect 
for iirplementing this application. When you execute 
man, something like the following appears: 



Directory of /dd/USR/MAN 00:11:48 




CLib 


Datamod 


MacPaint 


Mail 






MaxiPic 


Mkdir 


NBS 


Pilot 






Shell 


TelStar 


Tiny 


UltiMuse 






Xcom9 


Xlisp 





Which manual entry: 

You then type the name at the prcrrpt (or press ENIER 
to ignore) and the docunentation is available. Note 
that the exact names will depend on what you have in 
the /dd/usr/man directory. This exanple shows what 
I have in mine at the present time. The man script 
looks like the following: 

*tTian - manual processor 

onerr goto repeat 

cd /dd/usr/man 

echo 

dir /dd/USR/MAN 
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echo 

^repeat 

prcnpt Which manual entry: var.O 

if -r %0 

echo 

echo Manual for %0: Use SPACE/B to page through, 
Q to quit 

/dd/ands/more %0 
else 

if %0 >= a 
clrif 

echo — man: No manual entry for %0 
goto repeat 

fi 
fi 

The '*man" included in this archive is a datarrod 
version, and will lock slightly odd if you try to 
list it. If you want the pure ASCII, use Ron 
Lairmardo's datamod or take it frcm this text file. 
It helps to keep the directory sorted (or you may 
want to use one of the "LS" type connands which 
print ordered directories). 

Tyme - Digital Clock 



expensive computers into cheap clocks, myself 
included. I have used the new shell, along with 
DATE, DISPLAY, and SLEEP to create an on-screen 
digital clock. It doesn't do anything but sit there 
and display the date and time in the middle of an 80 
colurm window. Use it when you are going to leave 
your computer idle for a few minutes. To stop it, 
use control-E. 

*tyme 

onerr goto +trap 

tmode -pause 

display c 05 20 

^repeat 

display 2 3a 2b 

date t 

sleep 30 

goto repeat 

*trap 

display c 05 21 

date t 

echo Tyme end. 

Use these as supplied, or use them to generate 
ideas for your own shell+ scripts. 



We all seem fascinated with turning our Steve Clark - Corpuserve 73135,1204 <EOF> 

OCX>DCKX>CKX3C00C0CXXXX)OOOOOOCXXX) 

Chapter 14 - Example Programs 
WHY IHIS OiAFIER? 



Although every program in this tutorial has been 
a complete program, each one has also been a very 
small program intended to teach you sane principle 
of prograirming in C. It would do you a disservice 
to leave you at that point without introducing you 
to a few larger programs to illustrate how to put 
together the CCTistructs you have learned to create a 
major program. This chapter contains four programs 
of increasing ccnplexity, each designed to take you 
into a higher plateau of prograrrming, and each 
designed to be useful to you in seme way. 

DOSEX will illustrate how to make DOS system 
calls and will teach you, through self-study, how 
the system responds to the keyboard. WHAINEXT reads 
cormands input on the comiand line and will aid you 
in setting up a variable batch file, one that 
requests an operator input and responds to the input 
by branching to a different part of the batch file. 

LIST is the source code for the program you used 
to print out the C source files when you began 
studying C with the aid of this tutorial. Finally we 
come to VC, the Visual Calculator, which you should 
find to be a useful program even if you don*t study 
its source code. VC uses most of the programning 



techniques we have studied in this course and a few 
that we never even mentioned such as separately 
ccnpiled subroutines. 

We will take a look at the example programs one 
at a time but without a conplete explanation of any 
of them because you have been studying C for some 
time now and should be able to read and understand 
most of these programs on your own. Che other thing 
mast be mentioned, these programs use lots of 
nonstandard constructs and you will probably need to 
modify seme of them to get them to ccnpile with your 
particular ccnpiler. That will be left as an 
exercise for you. 

DOSEX. C - The DOS Exanple Program 

The copy of DOS that you received with your IBM- 
PC or conpatible has about 50 internal DOS calls 
that you can use as a prograrrmer to control your 
peripheral devices and read information or status 
from them. Seme of the earlier IBM DOS manuals, DOS 
2.0 and earlier, have these calls listed in the back 
of the manual along with how to use them. Most of 
the manuals supplied with ccupatible ccnputers make 
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no mention of these calls even though they are 
extremely useful. These calls can be accessed from 
nearly any prograitming language but they do require 
some initial study to learn how to use them. This 
program is intended to aid you in this study. 

Display the program on your monitor or print it 
out for reference. It is merely a loop watching for 
a keyboard input or a change in the time. If either 
happens, it reacts accordingly. In line 23, the 
function "kbhitO" returns a value of 1 if a key has 
been hit but not yet read from the input buffer by 
the program. This is a nonstandard function and may 
require a name change for your particular ccmpiler. 
There will probably be several similar calls that 
will need changed for your ccnpiler in order to 
compile and run the programs in chapter 14. 

Look at the function named "get_tinie" for an 
example of a DOS call. An interrupt 21(hex) is 
called after setting the AH register to 2C(hex) = 
AACdecimal). The time is returned in the CH, CL, 
and DH registers. Refer to the DOS call definitions 
in your copy of DOS. If the definitions are not 
included there, Peter Nortons book, 'T^ogramners 
Guide to the IBM PC" is reccmrBnded as a good 
reference manual for these calls and many other 
prograrrming techniques. 

Another useful function is the "pos_cursor()" 
function that positions the cursor anywhere on the 
monitor that you desire by using a DOS interrupt. 
In this case, the interrupt used is lO(hex) which is 
the general monitor interrupt. This particular 
service is number 2 of about 10 different monitor 
services available. This particular function may 
not be needed by your ccmpiler because some 
conpilers have a cursor positioning function 
predefined for your use. This function is included 
here as another example to you. 

The next function, service number 6 of interrupt 
lO(hex) is the window scroll service. It should be 
self explanatory. In this program, the cursor is 
positioned and some data is output to the monitor, 
then the cursor is "hidden" by moving it to line 26 
which is not displayed. After you ccnpile and run 
the program, you will notice that the cursor is not 
visible on the monitor. This is possible in any 
program, but be sure to put the cursor in view 
before returning to DOS because DOS does not like to 
have a "hidden" cursor and may do sane strange 
things . 

Seme time spent studying this program will be 
valuable to you as it will reveal how the keyboard 
data is input to the ccnputer. Especially of 
importance is how the special keys such as function 
keys, arrows, etc. are handled. 

WHATNEXT.C - The Batch File Interrogator 



This is an example of how to read the data on 
the ccrrmand line following the function call. Notice 
that there are two variables listed within the 
parentheses following the mainO call. The first 
variable is a count of words in the entire comnand 
line including the command itself and the second 
variable is a pointer to an array of pointers 
defining the actual words on the command line. 

First the question on the caimand line, made up 
of some nuntier of words, is displayed on the monitor 
and the program waits for the operator to hit a key. 
If the key hit is one of those in the last "word" of 
the group of words on the comnand line, the number 
of the character within the group is returned to the 
program where it can be tested with the "error level" 
ccnmand in the batch file. You could use this 
technique to create a variable AUIDEXEC.BAT file or 
any other batch file can use this for a many way 
branch. Compile and run this file with TEST. BAT for 
an example of how it works in practice. You may 
find this technique useful in one of your batch 
files and you will almost certainly need to read in 
the coTTTiand line parameters someday. 

An interesting alternative would be for you to 
write a program named "UCXJLD.C" that WDuld return a 
1 if a 'V or "y" were typed and a zero if any other 
key were hit. Then your batch file could have a 
line such as; 
WOULD YCU LIKE TO USE THE ALTERNATIVE METHOD (Y/N) 

Dos would use "WMJ)" as the program name, 
ignore the rest of the statement except for 
displaying it on the screen. You would then respond 
to the question on the monitor with a single keyhit. 
Your batch file would then respond to the 1 or 
returned and either run the alternative part of the 
batch file or the primary part vtetever each part 
was. 

WOULD YOU LIKE PRIMARY (Y/M) 
IF ERRCRLEVEL 1 0010 PRIMARY 
(secondary cotrmands) 
0010 DONE 
rPRIMARY 

(primary cormands) 
:D0NE 

LIST.C - The Program Lister 

This program is actually ccnposed of two files, 
LIST.C and LISTF.C that most be separately ccnpiled 
and linked together with your linker. There is 
nothing new here and you should have no trouble 
ccnpiling and linking this program by reading the 
docunentation supplied with your ccnpiler. 

The only thing that is new in this program is 
the inclusion of three "extern" variables in the 
LISTF.C listing. The only purpose for this is to 
tie these global variables to the nain program and 
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tell the carpi ler that these are not new variables. 
The cocrpiler will therefore not generate any new 
storage space for them but siiiply use their names 
during the cocrpile process. At link time, the 
linker will get their actual storage locations from 
the LIST. OBJ file and use those locations for the 
variables in the LISTF part of the memory map also. 
The variables of those names in both files are 
therefore the sams identical variables and can be 
used just as any other global variables could be 
used if both parts of the program were in one file. 

There is no reason why the variables couldn't 
have befen defined in the LISTF.C part of the program 
and declared as "extern" in the LIST.C part. Seme 
of the variables could have been defined in one and 
seme in the other. It is merely a matter of 
personal taste. Carried to an extreme, all of the 
variables could have been defined in a third file 
and named "extern" in both of these files. The 
third file would then be conpiled and included in 
the linking process. 

It would be to your advantage to conpile, link, 
and run this program to prepare you for the next 
program which is composed of 5 separate files which 
must all work together. VCX - The Visual Calculator 
This program finally ties nearly everything together 
because it uses nearly every concept covered in the 
entire tutorial. It is so big that I will not even 
try to cover the finer points of its operation. 
Oily a few of the more iirportant points will be 
discussed. 

The first thing you should do is go through the 
tutorial for VC included in the file VC.DOC. There 
are several dozen steps for you to execute, with 
each step illustrating some aspect of the Visual 
Calculator. You will get a good feel for what it is 
capable of doing and make your study of the source 
code very profitable. In addition, you will probably 
find many ways to use the Visual Calculator to 



solve problems involving calculations where the 
simplicity of the problem at hand does not warrant 
writing a program. 

Notice that the structure definitions, used in 
all of the separate parts of the program, are 
defined in the file STRUCT. DEF. During program 
development, when it became necessary to change one 
of the structures slightly, it was not necessary to 
change it in all of the files, only one file 
required modification which was then "included" in 
the source files. Notice that the transcript data 
is stored in a doubly linked list with the data 
itself being stored in a separate dynamically 
allocated char string. This line is pointed to by 
the pointer "lineloc". 

For ease of development, the similar functions 
were grouped together and compiled separately. 
Thus, all of the functions involving the monitor 
were included in the file named VIDEO. C, and all of 
the functions involving the data storage were 
grouped into the FIIE.C collection. Dividing your 
program in a way similar to this should sinplify 
debugging and future ncdifications. 

Of special interest is the "monitorO" function. 
This function examines the video mode through use of 
a DOS carroand and if it is a 7, it assumes it is a 
monochrome monitor, otherwise it assumes a color 
monitor. The colors of the various fields are 
established at this time and used throughout the 
program. Most of the data is written directly to 
the video memory, but seme is written through the 
standard BIOS routines. 

The file DEFIN.C is siirply a catalogue of the 
functions to aid in finding the functions. This file 
was generated as one of the first files and was 
maintained and updated for use during the entire 
design and coding lifetime. 

Feel free, after understanding this code, to 
modify it in any way you desire for your own use. 



ooooooooooOOOOOOOOCOoooooooooo 

OZ - 0S9 BBS 

by Rod Holden - Sysop 



Hi, this is your Sysop once again letting you know 
how the BBS is coming along and what sort of info is 
available. 

The King James bible is now unpacked. I had to be 
careful when unpacking it because for instance when 
you unpack John and then unpack John_l, John_l will 
write over the top of John, because the filenames 
had spaces in them. To get around this problem you 
must first unpack John_l which will show as John 
then rename that file to John_l or John.l or how 
ever you like to rename that file. Sorry if anyone 
was misled in the newsletter which mentioned about 



the bible scanner. It is currently being written so 

stay tuned to this station. 

In the 0S9JJn (0S9 Utilities) directory there is a 

file called FIXDCT.AR which has two programnes 

called Fixtxt and Lf2Cr. Here is the doc file about 

it: 

Fixtxt 

Use: Fixtxt path 
or: FLxtxt <pathl >path2 
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Strips linefeeds and other control codes, fixes 
backspaces, tabs, and removes trailing spaces. A 
large buffer is used for significant time savings 
over sintLlar programs. 

LfZCr 



disk will be returned) so other users can obtain a 

copy. 

I said in the newsletter that I was adding a second 

HD to nriy system as I was running out of space for 

the BBS, I now have that second HD which gives a 

total space of 90MB. 



Use: IfZcr path 
or: lf2cr <pathl >path2 

Similar to fixtxt, except it replaces linefeed with 
carriage returns. 

Warning: The non-filter mode of these programs will 
modify the file. Use CWLY on text files, and use a 
backup if the text is important! 



Logging Oi. 

Please contact me before logging on so I can enter 
your name in the user log. Ihen, when you 'log on* 
to the BBS type ycxir name (eg: Rod Holden), press 
enter, then press enter at the password pronpt. If 
'setup' is available to you, go into that area and 
set the option for number of lines per page (24 is 
what most users set) and also the option for change 
of password and enter your password. 



If anyone in the user group has software that is PD 
(that is not in the PD library and is not corrrnercial 
software) feel free to upload it to the BBS or send 
a copy to Bob Devries or Jean-Pierre Jacquet (your 



Well that's it from me till next time see you in the 

bit stream. 

Your Sysop 
Rod Holden 



PS. New tinES f or OZ - 089 BBS are 2000 - 2230hrs (AEST) 

ooooocxDocK^OOOOOOOOOOoooooooooo 

Rewrite, A utility to strip the front from a file 
by Bob Devries 



I recently had the need to strip seme garbage 
characters from the front of an otherwise perfectly 
good file. As usual, I had to write it nnyself . 
Here is the source in C. I first wrote it for use 
on iny Amiga 2000, using SAS/C, which is ANSI 
ccmpatible, and then copied it to the Colour 
Conputer under 0S9, and, yep, you guessed it, it 
didn't >rork, even when I had converted what I 
thought was all the necessary parts. 
It seems that the 0S9 C compiler is quite different 
in quite a few areas. Firstly, I used the function 
'sscanf ' to convert the ASCII carmand line into a 
long variable. I came unstuck there. On the Amiga, 



I had written 'sscanf(argptr,"%lx",&offset)' , and 
left the 'Ox' on the front of the ccnmand line 
variable. This does not wrk for CoCo 0S9 C. As 
you can see, I had to remove the 'Ox', and change 
the function call to 'sscanf(argptr,"%X",&offset)' . 
Notice the capitalisation of the '%X' . Refer to the 
C manual on page 4-26 (as I should have done - it 
doesn't pay to be too sure of yourself). In the 
Amiga version, I also added the 'Ox' instead of the 
user supplied '$'. This was also unnecessary. Ok, 
so after a bit of trial and error, here is the code. 

Bob Devries 



/* rewrite -(c) 1993 Bob Devries */ 
/* rewrites the specified file from */ 
/* the specified offset. Offset may */ 
/* be either decimal or hexadecimal */ 
/* e.g. 0x498 = $498 = 1176 */ 

^include <stdio.h> 
^include <string.h> 

#def ine TRUE 1 

main(argc, argv) 
int argc; 
char *argv[i ; 
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FILE *in, *out, *fopen(); 

int ch; 

char tefTp[32]; 

char *argptr; 

long offset = OL; 

long atolO; 

argptr = argv[3] ; /* point to the offset */ 

if (argc != 4) < /* oops, user error */ 

fprintf(stderr/tfsage: %s <infile> <outfile> <offset>\n",argv[0]); 

fprintf(stderr," <offset> may be either decimal or\n"); 

fprintf(stderr," hexadecimal, (e.g. 0x498 or $498)\n"); 

exit(O); 
> 

if ((in = fopen(argv[l],"r")) = NULL) { 

fprintf(stderr, "Can't open %s for input. \n",argv[l]) ; 
exit(ermo) ; 

> 

if ((out = fopen(argv[2]/V')) = NULL) < 

fprintf(stderr, "Can't open %s for output. \n'*,argv[ 2]) ; 

exit(ermo); 
> 

if ((argv[3][0] = '0') && (toupper(argv[3] [1]) = 'X')) < 

argptr +=2; /* increment past the Ox */ 

sscanf (argptr, "%X",&off set) ; 
} else if (argv[3][0] ='$'){ 

strcpy(tenp,-H-argptr); /* increment past the $ sign */ 

sscanf ( temp, "%X",&off set); /* the %X mast be capitalised */ 
} else { 

offset = atol(argv[3]); 
} 

fseek(in,of fset,0) ; 

v;hile (TRUE) < 

if ((ch = getc(in)) = EOF) break; 
putc(ch,out); 
> 

fclose(in); 
f close(out) ; 
> 

/* EOF */ 

ooooooooocOCCOOOCOOOoooooooooo 

Conversation of Interest /Help 
by Rod Holden 

Here is a conversation that took place between available and running. And I was amazed (after 
rnyself and Bob Devries. inheriting a collection of 'The Rainbow* dating back 

We were talking about how long 059 has been to 1983) at reading seme of the articles. I said to 
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Bob that I feel rather cheated because I wasn't 
aware that 039 had been going for so long. I bought 
rny CoCo3 back in 1988 and I learned about 089 was in 
1989. I said to Bob that I will never be able to 
make up for lost time, not to worry we all feel the 
same way at one stage or another. I said my 
expertise on 089 wculd fit on the head of a pin, so 
to all you users out there, here I am running the 
National 0S9 User Group BBS with limited knowledge 
of 089. So if you feel like asking questions no 
matter how big or small or silly please contact us 
in Brisbane by letter or by logging on to the BBS, 
or by phone and we will try very hard to answer your 
questions. 



089 Level II is a system that shocks those users who 
have been using it for a long, and I can still hear 
them say '*why did it do that" or "the instructions 
said it is supposed to do this" but it didn't why 
not?? Do you sit there for hours scratching your 
head reading the instructions over and over again 
till you either give up in disgust or throw the 
instructions away and you try sonsthing different 
and find it works, or do you ring someone for help, 
or forget all about it because asking makes you feel 
like an idiot. Does this sound like you, if so 
don't dispair, as I said earlier help is around the 
comer. We await your questions. 

bye 
Rod Holden 



ooooooooooOOCOOOOCOOoooooooooo 

Ment>ers' Questions and Answers 

Brian Palmer, of Balgownie, NSW asks: 

I would like to know if there is any way to use the ORCHESTRA 90CC cartridge under 089, and also if 
there is a way to piggy-back the disused 128K RAM chips, on top of the already installed 512K RAM board. 

ANSWER 1. I see no reason why the ORCHESTRA 90CC cartridge could not be used under 0S9, however, as far 
as I know, no-one has as yet done so. If someone wrote a programne to use it, it would have to be written 
like Kevin Darling's 'PLAY' conirand, which plays masic through the monitor speaker. The main problem with 
this programme, is that it stops the interrupts, thus not allowing nulti-tasking , which is \^dlat 0S9 is all 
about. 

ANSWER 2. No, the chips removed when you upgrade to 512K are of a different type than those used in the 
512K board, and most not be piggy-backed en them. Perhaps if someone who is clever in electronic design 
could have a look at the circuit diagram for the RAM board in 'The Rainbow' , by Tcoy Distafano seme time 
back, they could perhaps be used there. How about it semeone? I know there are seme electronics experts 
down Melbourne way! 



Hope this helps. 



Bob Devries 



ooooooooooOOOOOOOOOOoooooooooo 
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